lib/remote: Add a getter for OstreeRemote.name

Now that we’ve got a public, sealed OstreeRemote structure, we can start
carefully exposing members of it as API.

Signed-off-by: Philip Withnall <withnall@endlessm.com>
Closes: #875
Approved by: cgwalters

diff --git a/apidoc/ostree-experimental-sections.txt b/apidoc/ostree-experimental-sections.txt
index 790feb33fb604151452151053c4b804e9ab33db1..998a4f9c47ad0f46e32c0fcb5e2e47c6fbe28d3e 100644 (file)
--- a/apidoc/ostree-experimental-sections.txt
+++ b/apidoc/ostree-experimental-sections.txt
@@ -3,4 +3,5 @@
 OstreeRemote
 ostree_remote_ref
 ostree_remote_unref
+ostree_remote_get_name
 </SECTION>

diff --git a/src/libostree/libostree-experimental.sym b/src/libostree/libostree-experimental.sym
index e2ab4ea8bb88f70e1defe12f527605dbb75018fe..1d4feedaaf234fcde1478f5d59f45b9f9896aea7 100644 (file)
--- a/src/libostree/libostree-experimental.sym
+++ b/src/libostree/libostree-experimental.sym
@@ -29,3 +29,8 @@ global:
   ostree_remote_ref;
   ostree_remote_unref;
 } LIBOSTREE_2017.6;
+
+LIBOSTREE_2016.7_EXPERIMENTAL {
+global:
+  ostree_remote_get_name;
+} LIBOSTREE_2017.6_EXPERIMENTAL;

diff --git a/src/libostree/ostree-remote.c b/src/libostree/ostree-remote.c
index 86fae8d8ae59c3c19009fb9242a50d03fedff30c..f34fafa45170701ab8d6b26d68a5a8497b2d8d57 100644 (file)
--- a/src/libostree/ostree-remote.c
+++ b/src/libostree/ostree-remote.c
@@ -148,3 +148,23 @@ G_DEFINE_BOXED_TYPE(OstreeRemote, ostree_remote,
                     ostree_remote_ref,
                     ostree_remote_unref);
 #endif
+
+/**
+ * ostree_remote_get_name:
+ * @remote: an #OstreeRemote
+ *
+ * Get the human-readable name of the remote. This is what the user configured,
+ * if the remote was explicitly configured; and will otherwise be a stable,
+ * arbitrary, string.
+ *
+ * Returns: remote’s name
+ * Since: 2017.7
+ */
+const gchar *
+ostree_remote_get_name (OstreeRemote *remote)
+{
+  g_return_val_if_fail (remote != NULL, NULL);
+  g_return_val_if_fail (remote->ref_count > 0, NULL);
+
+  return remote->name;
+}

diff --git a/src/libostree/ostree-remote.h b/src/libostree/ostree-remote.h
index 8e96213cdbe468d65967969eb7f5e19d14ca7909..5505bc1d95f0cea5770081b74284f08d1a2be60f 100644 (file)
--- a/src/libostree/ostree-remote.h
+++ b/src/libostree/ostree-remote.h
@@ -60,4 +60,7 @@ void ostree_remote_unref (OstreeRemote *remote);
 #endif /* GI_SCANNER */
 #endif
 
+_OSTREE_PUBLIC
+const gchar *ostree_remote_get_name (OstreeRemote *remote);
+
 G_END_DECLS